BASIC/RT-11 VO1B 
Release Notes 


Order No. DEC-11-LBRNA-B-D 


ABSTRACT 


This document describes the differ- 
ences between BASIC/RT-11 VO1B and 
BASIC/RT-11 V01-05. It also de- 
scribes the problems and solutions 
associated with generating and run- 
ning BASIC/RT-11 V0O1B systems. The 
system manager should read this en- 
tire document before generating the 
system as described in the RT-1l 


System Generation Manual (DEC-ll- 
ORGMA-A-D). 


digital equipment corporation - maynard, massachusetts 


First Printing, January 1976 
Revised, July 1976 


The information in this document is subject to change without notice 
and should not be construed as a commitment by Digital Equipment 
Corporation. Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this document. 


The software described in this document is furnished under a license 
and may be used or copied only in accordance with the terms of such 
license. 


Digital Equipment Corporation assumes no responsibility for the use or 


reliability of its software on equipment that is not supplied by 
DIGITAL. 


Copyright (c) 1976 by Digital Equipment Corporation 


The postage prepaid READER'S COMMENTS form on the last page of this 
document requests the user's critical evaluation to assist us in pre- 
paring future documentation. 


The following are trademarks of Digital Equipment Corporation: 


DIGITAL DECsystem-10 MASSBUS 
DEC DECtape OMNIBUS 
PDP DIBOL 0S/8 

DECUS EDUSYSTEM PHA 
UNIBUS FLIP CHIP RSTS 
COMPUTER LABS FOCAL RSX 

COMTEX INDAC TYPESET-8 
DDT LAB-8 TYPESET-10 


DECCOMM DECsystem-20 TYPESET-11 


CONTENTS 


INTRODUCTION 
Documentation Conventions 
DIFFERENCES BETWEEN BASIC/RT-11 VOiB AND BASIC/RT=11 
vo1-05 
Problems in V01-05 That Are Corrected in VO01B 
Unpublished Problems in V01-05 That Are Corrected 
in VO1B 
CHANGES AND RESTRICTIONS 
Syntax Errors in Multiple Statement GOSUB or in 
DEF Statement 
SAVE Command to Magtape and Cassette 
Bottom Address When Linking BASIC 
Column Width 
Stack Size 
String Storage Garbage Collection Pause 
Module Addresses in Distributed SAV Files 
Background Display with F/B Monitor 


iii 


Wh 


SOW & & & h 


BASIC/RT-11 V01B RELEASE NOTES 


1.0 INTRODUCTION 


This document describes the differences between BASIC/RT-11 VO1B and 
BASIC/RT-11 V01-05. It also describes the problems and solutions as- 
sociated with generating and running BASIC/RT-11 V0O1B systems. The 

‘system manager should read this entire document before generating the 


system as described in the RT-1l System Generation Manual (DEC-11- 
ORGMA-A-D). For information on related RT-11 documents, see the RT-11 


Documentation Directory (DEC-11-ORDDA~-A-D) . 


1.1 Documentation Conventions 


The following are the conventions and abbreviations used throughout 
this document: 


1. All numbers are listed in octal unless otherwise in- 
dicated. 


2. <CR> indicates that the RETURN key should be typed 
at that place in the dialogue. 


3. Underliining indicates computer output when it is 
necessary to differentiate output from user input. 


4. “C indicates that a CTRL C should be typed at that 
place in the dialogue. 


2.0 DIFFERENCES BETWEEN BASIC/RT-11 V01B AND BASIC/RT-11 V01-05 


Outlined below are the major differences between BASIC/RT-11 VO1B and 
BASIC/RT-11 V01-05; users upgrading from V01-05 to V01B should be 
aware of these differences. 


1. Problems with BASIC/RT-11 v01-05 for which an article 
and/or patch was published in the Digital Software 
News. 


2. Problems with BASIC/RT-11 V01-05 for which no article 
was ever published. 


3. The Lab LPS support and the graphic GT-44 support are 
not included in the BASIC/RT-11 kit. 


Note that in all cases in both categories, the problems have been cor- 
rected in BASIC/RT-11 VO1B; pup laahee patches should not be applied to 
BASIC/RT-11 VO1B. 


2.1 Problems in V01-05 That Are Corrected in VO1B 


The following are problems that existed in BASIC/RT-11 V01-05 for which 
an article and/or patch was published in the Digital Software News. 


Problem/Article Name D.S.N. Sequence # 
l. Erroneous Results When Using Virtual Files 5 
2. Overlay Command Produces "?ULN" Error 6 
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Overlay Appears to Scratch Data Area 7 
(Note that it is no longer necessary 

to follow overlay statements with a 

RESTORE statement.) 


Reference to 128-Character String Virtual 10, 11 
File Causes BASIC to HALT 


"2ETC" from Long Programs Running in 12 
Machines Greater Than 16K 


Unpublished Problems in V01-05 That Are Corrected in V0O1B 


The following is a list of problems that existed in BASIC/RT-11 v01-05 
for which no article or patch was ever published. Where applicable, a 


Section from the BASIC/RT-11 Language Reference Manual is given for 
reference. 


l. 


BASIC virtual memory files, as produced by BASIC/RT-11 V0O1B, are 
completely compatible with FORTRAN/RT-11 direct access files. 


The BASIC "POS (X$,Y$,2)" function now produces correct results 
for all values of Z. (Section 6.3) 


The "OVERLAY" command no longer changes the current program name. 
BASIC now handles input lines up to 132 characters. 


The user-defined function evaluation algorithm has been changed 
to correct a problem that occasionally generated incorrect re- 
sults. The problem occurred when the user-defined function used 
more than one argument, and the same argument names were used in 
the model statement (DEF) and the executable statement. For ex- 
ample: 


10 DEF FNA(X,Y)=X+Y 
20 X=2 
30 PRINT FNA(10,X) 


These statements caused 20, rather than 12, to be printed. 


The power fail support in BASIC, which was minimal, has been re- 
moved. (Section 1.1) 


A problem that occurred in overlaid versions of BASIC, due to the 
initial value of the stack pointer, has been corrected. The prob- 
lem caused an area of memory, from approximately 23706 to 23776, 
to be overwritten since it was used by the overlay processor as 
stack space. 


When input from the high speed reader is used, no "*" PECmpe char- 
acter is typed. (Section 5.5.2.1) 
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3.0 CHANGES AND RESTRICTIONS 


BASIC/RT-11 users should always keep abreast of BASIC-related notices 
‘published by DIGITAL. Changes published in the Software Performance 
Summary need be made only once and should be made immediately. Changes 
published in the Digital Software News should be made as soon as pos- 
sible to systems in use. In addition to continued surveillance of the 
above documents, the user should be aware of the following changes 

and restrictions at installation time. 


Patches made with RT-11 PATCH, as described in this chapter, assume a 
non-overlaid version of BASIC is being patched. The following proce- 
dure is used when patching overlaid versions of BASIC: 

.R PATCH<CR> 


PATCH Version number 


FILE NAME -- [use BAS8K or name of overlaid ver- 
*BAS8K.SAV/0<CR> Sion being patched] 


?BOTTOM ADDR WRONG? 


* 400; B<CR> [use 400 or bottom address specified 
to LINK with /B if different] 
*nnnnnn ; OR<CR> {nnnnnn is BASICR address from link 
map] 
> [rest of procedure is same as for 
: non-overlaid versions] 


The error message ?BOTTOM ADDR WRONG? is expected. It is generated as 
a result of the way BASIC initializes the stack pointer in overlaid 
versions. 


3.1 Syntax Errors in Multip 


le Statement GOSUB or in DEF Statement 


If a syntax error appears in a multiple statement line after a GOSUB, 
the line number reported in the error message is not the line number 
containing the error. Instead, it is the line number of the RETURN 
statement which returned control after the GOSUB. For example, 


10 GOSUB 30 \ERROR 
20 STOP 
30 RETURN 


When RUN, the message ?SYN AT LINE 30 will appear instead of ?SYN AT 
LINE 10. 


Similarly, if a syntax error appears in the DEF statement for a user- 
defined function, the line number reported in the error message is not 
the line number containing the error. Instead, it is the line number 
of the statement which referenced the user-defined function. . For ex- 
ample: 


10 DEF FNA(X)=ERROR 
20 A=FNA(10) 
30 STOP 


When RUN, the message "?SYN AT LINE 20" will be printed instead of 
“SYN AT LINE 10". 
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3.2 SAVE Command to Magtape and Cassette 


When doing a SAVE to magtape or cassette, BASIC/RT-11 does not check 
to see if there is already a file on the magtape or cassette that has 
the same name as the file being saved. If a SAVE is done to disk or 
DECtape, BASIC checks for such a file and issues a "?RPL" message, in- 
dicating that the REPLACE command must be used. For magtape or cas- 
sette, the SAVE always deletes the old file and puts the new file on 
the tape. 


3.3 Bottom Address When Linking BASIC 


All distributed versions of BASIC/RT-11 V0O1B, except BAS8K.SAV, are 
linked with a bottom address of 500,; this is because the area below 
500, can be used for device interrupt vectors. If the user's configu- 
ration has no devices with vectors above 400., he can link any of the 
BASIC versions with a bottom address of 400,. The distributed version 
of BAS8K.SAV is standardly linked with a bo&tom address of 400, to al- 
low maximum user area in small machines. Users with 8K, whose configu- 
rations have interrupt vectors above 400,, should relink BAS8K.SAV with 


a bottom address of 500,- 


3.4 Column Width 


BASIC/RT-11 V01-05 had a fixed-column size of 72 characters for all _ 
devices. For BASIC/RT-11 V01B this column size may be changed for all 
devices by patching a single location. Attempting to PRINT on any de- 
vice past the highest column number, as specified by this location, 
causes BASIC to print an automatic carriage return/line feed and con- 
tinue output on the next line. 


The following example shows how to change the column width to 132 for 
all devices (including terminal). 


.R PATCH<CR> 
PATCH Version number 


FILE NAME -- 

* BASIC. SAV<CR> 

*500; OR<CR> [use 500 or BASICR address from link 
- map, if different] 

*0,10/ 110 204<CR> [column size in octal] 

*E 


The column size is stored in location COLSIZ, which is a global and ap- 
pears in the link map. It is at an offset of 10 (octal) from the be- 
ginning of BASICR. Note that once the patch is made, any BASIC program 
that depends on BASIC's printing an automatic carriage return/line feed 
at column 72 will generate different output. COLSIZ initially contains 
72. If its contents are changed to 'n', the TAB function is then done 
in modulo n rather than modulo 72. 


3.5 Stack Size 
BASIC/RT-11 uses part of the user area for its working stack. A por- 


tion of this stack is reserved for interrupt level routines (device 
handlers) that require stack space. The remainder is used by BASIC and 
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user assembly language routines. It is possible that some user-written 
modules, or interrupt level routines, will require more stack space 
than is currently reserved for them. Therefore, the following proce- 
dure can be used to increase the total amount of stack space, or the 
portion of that total reserved for interrupt level routines, or both. 
The two locations involved are STKEXT and STKSIZ. The first, STKEXT, 

is the number of bytes (must be even) of stack space reserved for inter- 
rupt level routines; the second, STKSIZ, is the total number of bytes 
(must be even) of stack space that may be used by BASIC, by interrupt 
level routines, and by user routines (includes STKEXT). 


Initially, the value of STKEXT is 40, and STKSIZ 200,. Since STKSIZ 
includes STKEXT, this means that the amount of stack space available 
for BASIC and user assembly language routines is 140,. To increase 
the amount of stack space available to interrupt level routines, both 
values should be increased by the desired number of bytes of stack 
space to be added. Locations STKEXT and STKSIZ are globals and will 
show up in the link map. They are at an offset of 14, and 12,, re- 
spectively, from the start of BASICR. 


The following example shows how to increase the stack space available 
to interrupt level routines (by 20g bytes) by adding 20, to the cur- 
rent values stored in STKSIZ and STKEXT: 


.«R PATCH<CR> 
PATCH Version number 


FILE NAME -- 
*®BASIC. SAV<CR> 
' *500; OR<CR> {use 500 or BASICR address from link 
map, if different] 
*0,12/ 200 220<CR> [STKSIZ] 
*0,14/ 40 60<CR> [STKEXT] 
*E 


If the user has the sources of BASIC/RT-1l, these patches can be made 
by defining the variables: 


SSTKSZ=220 
SSTKEX=60 


in an assembly parameter module and reassembling BASIC with this param- 
eter module as described in Appendix F of the BASIC/RT-11 manual. 


NOTE 


If the value of STKSIZ is increased by 
20g bytes and the value of STKEXT is not 
changed, no additional space is reserved 
for interrupt level routines, but an ad- 
ditional 20g bytes of stack space are re- 
served for BASIC and user assembly lan- 
guage routines. 


3.6 String Storage Garbage Collection Pause 


Versions of BASIC/RT-11 with string support periodically appear to hang 
for some time. This is usually noticed when using assembly language 
routines to drive some type of graphics display. This hang results 
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from the fact that each call of an assembly language routine causes a 
new string to be created (consisting of the name of the assembly lan- 
guage routine). When string storage becomes filled, BASIC performs a 
garbage collect operation, causing it to become internally compute- 
bound for a period of time. 


This problem affects programs doing real-time data acquisition, since 
BASIC can service interrupts and collect data during the garbage 
collect operation, but it can neither process the data collected nor 
write the data out to a file until the garbage collect is completed. 
For very fast sampling rates, the interrupt service must be able to 
buffer a large amount of data during a garbage collect operation in 
order to avoid data loss. 


The problem can be eliminated by linking the assembly language routines 
with the versions of BASIC that do not support strings. 


If string support is required, the following patch can be made to elim- 
inate the creation of a new string. each time an assembly language rou- 
tine is called. Note, however, that with this patch installed, string 
variables and string expressions are not allowed as the name of an as- 
sembly language routine in a CALL statement. Only a literal string, 
enclosed in quotes, may be used for the name. In addition, to prevent 
BASIC from hanging, users should ensure that no string constants, 
string variables, or string expressions appear inside a time-critical 
data collection loop (except for the name of the assembly language rou- 
tine in the CALL statement). The patch is made to location STRFND in 
BASICR, which is a global and appears in the link map. The contents 

of this location are changed from the address of subroutine FNDSTR to 
that of subroutine FNDSTL. Both these routines are globals and their 
addresses appear in the link map to facilitate changes back and forth. 


The patch is as follows: 
.R PATCH<CR> 
PATCH Version number 


FILE NAME -- 

*BASIC.SAV<CR> 

¥500;0R<CR> [use 500 or BASICR address from link 

a map, if different] 

*0,16/ 35160 3044<CR>[use 3044 or FNDSTL address from 

a link map, if different] 

*E 
Note that the old contents of location STRFND may vary with the version 
of BASIC being patched; 35160 is used for this example only. 


3.7 Module Addresses in Distributed SAV Files 


The following table lists the addresses of important modules in the 
distributed versions of BASIC. 
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-SAV File Bottom Address BASICR FPMP BASICE BASICX BASICH 


BAS 8K 400 1136 6072 12374 12374 24212 
BASIC 500 500 5776 12276 24666 37242 


3.8 Background Display with F/B Monitor 


When using BASIC with a background display routine (such as the LPS-11 
display routine) running as the background job under the F/B Monitor, 
the display is not refreshed when BASIC is waiting for keyboard input. 
This is because BASIC issues a .TTINR request and if no input is avail- 
able, BASIC refreshes the display. This is acceptable under S/J, but 
under F/B, control does not return from the .TTINR until a character is 
available, so BASIC cannot refresh the display. This problem can be 
avoided by setting bit 6 of the Job Status Word (location 44) for BASIC. 
This causes .TTINR under F/B to act as it does under the S/J Monitor. 


For example: 
«R PATCH<CR> 
PATCH Version number 


FILE NAME -- 

*BASLPS .SAV<CR> 

*44/ 0 100<CR> 
| a 


For overlaid versions: 
«R PATCH<CR> 
PATCH Version number 


FILE NAME -- 


*¥BGTLPO. SAV/0<CR> 


?BOTTOM ADDR WRONG? 
*500;B<CR> 


*¥44/ 1000 _1100<cR> 
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